home *** CD-ROM | disk | FTP | other *** search
/ Shareware Extravaganza - Disc 1 / ShareWare Extravaganza 1 of 4 (The Ultimate Shareware Company).iso / grprogs / art2wp.exe / ART2WP.DOC next >
Text File  |  1989-08-21  |  9KB  |  277 lines
  1.  
  2. ART2WP V1.6 First Publisher ClipArt to  Word Processor Image File Translator
  3.                      Copyright 1989 by William J. Hinkle
  4.  
  5.                             === User's Guide === 
  6.  
  7. The ART2WP program was created to allow clip art files created through the 
  8. PFS:First Publisher desktop publishing program to be used by word processing 
  9. programs that handle graphics, and in other graphics programs.  To do this, 
  10. ART2WP translates these ART files into any of several other graphics file 
  11. formats.  You can translate to:
  12.  
  13. * .WPG files (Word Perfect 5 graphics format)
  14. * .TIF files (Aldus/Microsoft TIFF format)
  15. * .BIT or .RLE files (Lotus Manuscript graphics format)
  16. * .IMG files (GEM Paint format)
  17. * .GIF files (CompuServe Graphics Interchange Format)
  18. * .PCX files (PC Paintbrush PCX Format)
  19.  
  20. The translator is a single file: ART2WP.EXE.  The default translation is to 
  21. Word Perfect 5 (.WPG) format
  22.  
  23. ==============
  24. COPYRIGHT INFO
  25. ==============
  26. This utility program ART2WP.EXE was written by
  27.  
  28.     William J. Hinkle
  29.  
  30. who retains the copyright.  Copy and use the program freely.  Distribute
  31. it to whomever you want.  But:
  32.  
  33. === Do NOT distribute modified versions.
  34. === Do NOT remove the copyright notice.
  35. === ALWAYS distribute with the documentation.
  36. === DO NOT charge a fee, except for disk copying/library charges.
  37.  
  38. If you feel that this program has been of some utility, please seriously 
  39. consider sending a contribution of up to $5.00 to help defray my
  40. costs run up in developing this utility.  Please indicate if you desire a 
  41. written receipt.
  42.  
  43. William J. Hinkle
  44. 420 E.Boston Mills Rd.
  45. Hudson, OH 44236-1111
  46.  
  47.  
  48.  
  49. ===============
  50. BASIC OPERATION
  51. ===============
  52.  
  53. First create a PFS:First Publisher clip art file, which should have a .ART 
  54. extension on the filename.  These can be clipped from the .MAC art library 
  55. files, or perhaps obtained from local BBSs and other sources.
  56.  
  57. To create a .WPG file (the default), type in:
  58.  
  59. ART2WP fname1
  60. or
  61. ART2WP fname1.ART
  62. or
  63. ART2WP fname1.ART fname2.WPG
  64.  
  65. from the DOS command prompt.
  66.  
  67. * For "fname1", substitute the name of your clip art file, of course!
  68.  
  69. * The .ART and .WPG extensions are assumed if something else is not specified.
  70.  
  71. * The .WPG file name is made the same as the .ART file name if not otherwise 
  72. specified.  Specify a different "fname2" if desired.
  73.  
  74. * Full DOS pathnames can be specified.  If you enter a directory (ending in \) 
  75. or a drive (ending in :) for the second ("fname2") filename, the output file 
  76. will be placed on that path with the default filename; i.e, the input filename 
  77. with a .WPG extension.
  78.  
  79. The .ART file will be translated to a .WPG file.
  80.  
  81. The .ART file will not be erased.  You can also specify scaling factors, but
  82. the defaults work the best (see below).
  83.  
  84.  
  85.  
  86. ==================
  87. OTHER FILE FORMATS
  88. ==================
  89.  
  90. To create a new graphics file in one of the other supported formats, you must 
  91. specify the other format.  You have two ways to do this.  One way is to 
  92. specify the output filename ("fname2") with the appropriate extension.  The 
  93. other is to specify the special /f option switch that selects the desired
  94. format.  The second method is usually the best, because the .ART file's 
  95. filename is then automatically used for the output file.
  96.  
  97. Some examples:
  98.  
  99. ---
  100. * To get a Aldus/Microsoft TIFF file:
  101.  
  102. ART2WP fname1 /ft
  103. or
  104. ART2WP fname1.ART fname2.TIF
  105.  
  106. gives you a TIFF file.
  107.  
  108. ---
  109. * To get a Lotus Manuscript graphics file:
  110.  
  111. ART2WP fname1 /fb
  112. or
  113. ART2WP fname1.ART fname2.BIT
  114.  
  115. or, for RLE files, which are often smaller:
  116.  
  117. ART2WP fname1 /fr
  118. or
  119. ART2WP fname1.ART fname2.RLE
  120.  
  121. ---
  122. * To get a GEM Paint graphics file:
  123.  
  124. ART2WP fname1 /fi
  125. or
  126. ART2WP fname1.ART fname2.IMG
  127.  
  128. ---
  129. * To get a CompuServe GIF file:
  130.  
  131. ART2WP fname1 /fg
  132. or
  133. ART2WP fname1.ART fname2.GIF
  134.  
  135. ---
  136.  
  137. * To get a ZSoft PC Paintbrush PCX file
  138.  
  139. ART2WP fname1 /fp
  140. or
  141. ART2WP fname1.ART fname2.PCX
  142.  
  143.  
  144.  
  145. ==============
  146. COMPLEAT USAGE
  147. ==============
  148.  
  149. If you invoke ART2WP from DOS without any other parameters, it will display 
  150. the following help message.  This illustrates some of the other options you 
  151. can select with command line switches.
  152.  
  153. -----
  154. PFS:FP ART-to-WP Image File Translator: V1.6 ... Copyright 1989 by W.J.Hinkle
  155.  
  156.  
  157. Press a key to get a little help...
  158.  
  159. (...you press a key here, naturally!)
  160.  
  161. Usage: ART2WP fname1 [fname2] [option] [option] ...
  162. where: fname1.ART ... PFS: First Publisher ART input file
  163.        fname2.WPG ... Word Perfect 5 WPG output file (default: fname1.WPG)
  164.    or  fname2.TIF ... Aldus/Microsoft TIFF format output file
  165.    or  fname2.BIT ... Lotus Manuscript BIT format output file
  166.    or  fname2.RLE ... Lotus Manuscript RLE format output file
  167.    or  fname2.IMG ... GEM IMG format output file
  168.    or  fname2.GIF ... CompuServe GIF format output file
  169.    or  fname2.PCX ... PC Paintbrush PCX format output file
  170.        /xN        ... option: x density = N pixels-per-inch (default: 100)
  171.        /yN        ... option: y density = N lines-per-inch (default: per x)
  172.        /v         ... option: reverse video
  173.        /ft        ... option: force TIFF output file
  174.        /fb        ... option: force BIT (Lotus Manuscript) output file
  175.        /fr        ... option: force RLE (Lotus Manuscript) output file
  176.        /fi        ... option: force IMG (GEM) output file
  177.        /fg        ... option: force GIF (CompuServe) output file
  178.        /fp        ... option: force PCX (PC Paintbrush) output file
  179.  
  180. Press a key to continue...
  181.  
  182. ART2WP is a translator from First Publisher ART image files
  183. to various word processor image file formats:
  184.  
  185. To Word Perfect 5 WPG files (this is the default)
  186. or Microsoft/Aldus TIFF files (fname2.TIF, or use /ft option),
  187. or Lotus Manuscript BIT/RLE files (fname2.BIT/RLE, or use /fb, /fr options),
  188. or GEM IMG files (fname2.IMG, or use /fi option),
  189. or CompuServe GIF files (fname2.GIF, or use /fg option),
  190. or ZSoft PC Paintbrush files (fname2.PCX, or use /fp option).
  191.  
  192. PFS: First Publisher is a trademark of the Software Publishing Corporation.
  193. Word Perfect is a trademark of the Word Perfect Corporation.
  194. Manuscript is a trademark of the Lotus Development Corporation.
  195. GEM is a trademark of the Digital Research Corporation.
  196. GIF and 'Graphics Interchange Format' are trademarks of CompuServe Inc.
  197. PC Paintbrush is a trademark of ZSoft Corporation.
  198.  
  199. Shareware by: William J. Hinkle CIS [71121,3211]
  200.  
  201. (followed by some shareware info...)
  202.  
  203. -----
  204.  
  205.  
  206.  
  207. =============
  208. REVERSE VIDEO
  209. =============
  210.  
  211. Normally ART2WP keeps black and white the same between the ARTfile and the
  212. output file.  If you want a reverse video effect, use the /v option switch.
  213.  
  214. ==================
  215. SIZING AND DENSITY
  216. ==================
  217.  
  218. Normally ART2WP make a output file with an image density of 72x72 pixels (or 
  219. lines) per inch, the same as First Publisher uses.  This lets your program
  220. compute the "natural" size of the graphics image.  You can specify a different
  221. density by specifying it with either the /x or /y option switches (e.g. /x200
  222. is 200 pixels and lines per inch).  You can also alter the aspect ratio (to
  223. "stretch" the image one way or the other) by specifying both the /x and the
  224. /y option switches, with different density values.
  225.  
  226. Of course, you can usually scale the image in your other application program.
  227.  
  228.  
  229.  
  230. ======
  231. HELP?!
  232. ======
  233.  
  234. Should you have any difficulties using this program, please 
  235. contact me via Compuserve EasyPlex (or on the CompuServe PICS forum):
  236.  
  237. William J. Hinkle [71121,3211]
  238.  
  239. ======
  240. THANKS
  241. ======
  242.  
  243. Thanks to:
  244.  
  245. Tom Pfau, for his public domain LZW compression/decompression code
  246. Bruce Philp, for his help in testing this program
  247.  
  248. ==========
  249. LEGALITIES
  250. ==========
  251. PFS: First Publisher is a trademark of the Software Publishing Corporation.
  252.  
  253. Word Perfect is a trademark of the Word Perfect Corporation.
  254.  
  255. Manuscript and Lotus Manuscript are trademarks of the
  256. Lotus Development Corporation.
  257.  
  258. GEM is a trademark of the Digital Research Corporation.
  259.  
  260. GIF and 'Graphics Interchange Format' are trademarks of CompuServe Inc., an
  261. H & R Block Company.
  262.  
  263. PC Paintbrush is a trademark of ZSoft Corporation.
  264.  
  265. *************************************************************************
  266. *    Revision History:                                                    *
  267. *    -----------------                                                    *
  268. *    Version number    Date        Explanation                                *
  269. *    --------------    ------        --------------------------                *
  270. *        1.3            09 Feb 89    first public release                    *
  271. *                                 added GIF format output                *
  272. *        1.4          14 Feb 89    added TIFF Compression tag to satisfy    *
  273. *                                 Optiks 2.11 (why, I don't know!)        *
  274. *                                and reversed video on GIFs                *
  275. *        1.5          27 Feb 89    tweaked TIFF output (ordered tags)       *
  276. *        1.6            20 Aug 89    added PCX output and made DPI=72        *
  277.